home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / editor / words3.lha / Words / ISpell / ReadMe < prev    next >
Text File  |  1995-07-31  |  7KB  |  178 lines
  1.             International Ispell version 3.1 - Amiga Patch
  2.             ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. Introduction
  5. ~~~~~~~~~~~~
  6. This is a Amiga patch of the International Ispell version 3.1.
  7. There is a few differences between this patch and the Ispell 3.3ljr package:
  8.  * 3.3ljr is (AFAIK) based on Ispell version 2, thus not reflecting the
  9.    evolution of international Ispell since 1990.
  10.  * This patch makes only a few changes to the original UN*X code and should
  11.    therefore be compatible with Ispell releases to come (i.e. there is no
  12.    "porting" needed - It will be possible to simply get the newest release and
  13.    compile!).
  14.  * This patch compiles with GCC and needs ixemul.library - there is a much
  15.    bigger overhead compared with 3.3ljr!
  16.  * The EXTENDEDFILECHECK Arexx command has been removed.
  17.  
  18. You should read the "README" file - this file only covers a few Amiga specific
  19. areas.
  20.  
  21.  
  22. Archives
  23. ~~~~~~~~
  24. This Ispell patch will be integrated into the official Ispell source tree
  25. from version 3.1.20 or so. Until then I personally release the source and
  26. binaries in two archives:
  27.  
  28. ispell3.1.18src.lha - Original ispell-3.1.18 source archive with patch
  29.                       applied. Contains all needed sources for rebuilding
  30.                       ispell binaries and dictionaries.
  31. ispell3.1.18bin.lha - Contains binaries compiled for Amiga, docs and an
  32.                       English dictionary.
  33.  
  34.  
  35. Installation
  36. ~~~~~~~~~~~~
  37. Dictionaries are to be put in "ispell:lib/" and to ease upgrading you should
  38. put the binaries in "ispell:bin". Add the "ispell:bin" to your path.
  39.  
  40. Private dictionaries will by default be created in "ispell:lib/", named after
  41. the language e.g. '.ispell_english'. You may specify an absolute path/name for
  42. the dictionary with the -p option.
  43.  
  44.  
  45. Usage & Documentation
  46. ~~~~~~~~~~~~~~~~~~~~~
  47. Consult the man pages for general Ispell usage.
  48. You should know that I have removed the '-vv' option - if you need compile
  49. info check out the source archive.
  50.  
  51. The ARexx interface is more or less the same as the one found in 3.3ljr
  52. ispell. Consult the file "doc/AmigaArexx.doc" for a description of the Arexx
  53. interface.
  54. Since the operation of Ispell has changed from the days of 3.3ljr Ispell the
  55. old Ispell interfaces are not up-to-date. They may need a little patching
  56. themselves to be usable with Ispell 3.1.18. I included them to give you an
  57. idea of how to make an interface Ispell.
  58. If you use FrexxEd there should be an "FrexxEd - Ispell" interface available
  59. from next FrexxEd release.
  60.  
  61. For Amiga users without knowledge of man/groff and the like, I have included
  62. the man pages in "readable" form in Amiga/doc. If your reader can not
  63. understand the style codes, you can remove them with the type command:
  64. "type file > file.raw"
  65.  
  66.  
  67. GCC compilation
  68. ~~~~~~~~~~~~~~~
  69. First remove the suffix ".Amiga" from the Amiga specific versions of local.h
  70. and the Makefile.
  71.  
  72. Then simply "make programs". After removing the CheckIO() inline description
  73. in the inline/exec.h file, I was able to compile all the programs in the
  74. Ispell package without errors or warnings. The dictionaries are another story
  75. though; I had to "compile" them by hand without the use of make (run through
  76. the Makefile yourself).
  77.  
  78. All changes made in the original UN*X code are marked by a "#if(n)def AMIGA"
  79. condition.
  80.  
  81.  
  82. Dictionary Generation
  83. ~~~~~~~~~~~~~~~~~~~~~
  84. Get the source archive and find out how by reading the languages/README file.
  85. If you want to generate any of the dictionaries in the source archive you
  86. should do it by hand as the Makefile does not work on Amigas (doesn't on
  87. mine anyway).
  88.  
  89. As this may seem a bit tedious for the average user I ask anyone who
  90. successfully generate a dictionary file for a language to upload it to AmiNet
  91. and possibly notify Fred Fish!
  92.  
  93.  
  94. History
  95. ~~~~~~~
  96. 29.06.95 (patch level 1)
  97.  
  98. * All the server commands seem to be fully functional, but they have not been
  99.   tested extensively :(
  100. * There seems to be a memory loss of 440 bytes at each invokation - I think
  101.   it is a problem with ixemul or ispell as it occurs even if the ARexx server
  102.   is not started. I have not checked into it!
  103.  
  104. 03.07.95 (patch level 2)
  105.  
  106. * Added server command "ACCEPT".
  107. * The -p and -d options now use "correct" Amiga file name conventions.
  108.  
  109.  
  110. Legal blurb
  111. ~~~~~~~~~~~
  112. International Ispell Version 3.1.18 01/14/95
  113. Copyright (c), 1983, by Pace Willisson
  114. International version Copyright (c) 1987, 1988, 1990, 1991, 1992, 1993,
  115. by Geoff Kuenning, Granada Hills, CA.  All rights reserved.
  116.  
  117. Redistribution and use in source and binary forms, with or without
  118. modification, are permitted provided that the following conditions
  119. are met:
  120.  
  121. 1. Redistributions of source code must retain the above copyright
  122.    notice, this list of conditions and the following disclaimer.
  123. 2. Redistributions in binary form must reproduce the above
  124.    copyright notice, this list of conditions and the following
  125.    disclaimer in the documentation and/or other materials provided
  126.    with the distribution.
  127. 3. All modifications to the source code must be clearly marked as
  128.    such.  Binary redistributions based on modified source code
  129.    must be clearly marked as modified versions in the documentation
  130.    and/or other materials provided with the distribution.
  131. 4. All advertising materials mentioning features or use of this
  132.    software must display the following acknowledgment:
  133.      This product includes software developed by Geoff Kuenning and
  134.      other unpaid contributors.
  135. 5. The name of Geoff Kuenning may not be used to endorse or promote
  136.    products derived from this software without specific prior
  137.    written permission.
  138.  
  139. THIS SOFTWARE IS PROVIDED BY GEOFF KUENNING AND CONTRIBUTORS ``AS
  140. IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  141. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  142. FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL GEOFF
  143. KUENNING OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  144. INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  145. (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  146. SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  147. HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  148. STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  149. ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  150. OF THE POSSIBILITY OF SUCH DAMAGE.
  151.  
  152. ~
  153.  
  154. Amiga Patch 2 (03.07.95) by Jesper Skov.
  155.  
  156. This patch is based on the ARexx interface found in
  157. ISpell Version 3.3LJR, copyright (C) 1990, 1991, 1992 Loren J. Rittle.
  158. The documentation files are also from the ljr archive.
  159.  
  160. The ARexx interface is based on the MinRexx package by Tom Rokicki of Radical
  161. Eye Software.
  162.  
  163. Also included in this archive is the interfaces supplied by various people.
  164. Excerpt from the LJR readme:
  165.  
  166. Thanks to Mike Meyer for the mg interface to ISpell.
  167. Thanks to Willy G. J. Langeveld for enhanced TurboText interface to ISpell.
  168. Thanks to Christopher A. Wichura for the TurboText interface to GUISpell.
  169. Thanks to Steve Koren for the GNU EMACS interface to ISpell.
  170.  
  171.  
  172. / Jesper Skov
  173.   Sallingsundvej 47 st th
  174.   DK-9220 Aalbog Ø
  175.   Denmark
  176.  
  177.   Email: jskov@iesd.auc.dk
  178.